Port DIAGNOSTICS - CAN-FD¶
PEAK-HW Diagnostics
提供基于 ISO-TP 的 CAN-FD 原始诊断访问。若要基于诊断描述文件(如 ODX 或 CDD)进行符号化诊断,则需要 Add-on ecu.test diagnostics。
Stimulation¶
此端口不具备激励能力。
Properties 🛈¶
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Channel number |
‘1’ |
string |
当存在多个同类型控制器时,用于选择通道号。 |
||
CAN-FD timings |
hide details |
[show details, hide details] 显示值:
|
string |
CAN-FD 位速率与定时参数 – 可使用图形编辑器,或勾选 ‘show details’ 来处理各项具体数值 |
|
Clock frequency [MHz] |
CAN-FD 时序:‘show details’ |
[80, 60, 40, 30, 24, 20] |
int |
Clock frequency in Megahertz |
|
TSEG1 ❲仲裁阶段❳ |
CAN-FD 时序:‘show details’ |
int |
TSEG1(用于确定采样点) |
||
TSEG2 ❲Arbitration phase❳ |
CAN-FD 时序:‘show details’ |
int |
TSEG2(用于确定采样点) |
||
SJW ❲Arbitration phase❳ |
CAN-FD 时序:‘show details’ |
int |
同步跳转宽度 |
||
BRP ❲Arbitration Phase❳ |
CAN-FD 时序:‘show details’ |
int |
标称时间量子的时钟预分频 |
||
TSEG1 ❲数据传输阶段❳ |
CAN-FD 时序:‘show details’ |
int |
TSEG1(用于确定采样点) |
||
TSEG2 ❲数据传输阶段❳ |
CAN-FD 时序:‘show details’ |
int |
TSEG2(用于确定采样点) |
||
SJW ❲数据传输阶段❳ |
CAN-FD 时序:‘show details’ |
int |
同步跳转宽度 |
||
BRP ❲数据传输阶段❳ |
CAN-FD 时序:‘show details’ |
int |
快速数据时间量子的时钟预分频 |
||
抑制位速率切换 ❲BRS❳ |
☐ |
bool |
禁止在仲裁段与数据段之间切换位速率。 |
||
Mode |
Standard |
[Standard, Extended, All] |
string |
寻址模式(Standard = 11bit,Extended = 29bit) |
|
仅监听 |
☐ |
bool |
控制器运行在被动模式。自动 ACK 已禁用,无法发送 CAN 帧。 |
||
Transmission confirmation |
☐ |
bool |
启用确认式发送。Bus-Write test step 和 Send 工具作业会阻塞,直到报文成功传输到总线上或确认超时到期。 |
||
传输确认的超时时间 |
1000 |
int |
消息必须在此时间段(毫秒)内成功发送。否则会产生错误。(不得大于 64535ms)。仅在主动确认模式下使用。 |
Jobs 🛈¶
AuthenticationConfiguration¶
Authentication (0x29) AuthenticationConfiguration:Authentication (0x29) authenticationConfiguration (0x08):表示服务器所提供的认证配置。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - AuthenticationConfigurationResult - 或 NegativeResponse |
AuthenticationDeauthenticate¶
Authentication (0x29) DeAuthenticate:Authentication (0x29) deAuthenticate (0x00):请求退出已认证状态
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - AuthenticationDeauthenticateResult - 或 NegativeResponse |
AuthenticationProofOfOwnership¶
Authentication (0x29) ProofOfOwnership:Authentication (0x29) proofOfOwnership (0x03):校验来自客户端的所有权证明。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
EphemeralPublicKeyClient |
ByteStream |
客户端为 Diffie-Hellman 密钥协商生成的临时公钥。 ByteStream |
|||
ProofOfOwnershipClient |
ByteStream |
对先前给出的质询的所有权证明,由服务器校验。ByteStream |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - AuthenticationProofOfOwnershipResult - 或 NegativeResponse |
AuthenticationVerifyCertificateUnidirectional¶
Authentication (0x29) VerifyCertificateUnidirectional:Authentication (0x29) verifyCertificateUnidirectional (0x01):通过验证证书来启动认证。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
CertificateClient |
ByteStream |
要验证的证书。ByteStream |
|||
ChallengeClient |
ByteStream |
challenge(质询)包含整车厂特定格式的客户端数据(可能包含随机化信息),或者是一个随机数。此参数记录用于将该 challenge 传输到服务器。 ByteStream |
|||
CommunicationConfiguration |
int |
有关在 Authentication 之后如何在进一步的诊断通信中处理安全性的配置信息。 注 1 该信息与响应消息数据参数 sessionKeyInfo 是否存在及其内容相关。该参数的格式、会话密钥的生成以及证明值的计算均由整车制造商自行决定。 |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - AuthenticationVerifyCertificateUnidirectionalResult - 或 NegativeResponse |
CallService¶
执行诊断服务请求。
示例:要调用 UDS 服务 Read Data by Identifier(SID=0x22,DID=0xACDC),Request 为 ByteStream(“22 AC DC”)
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Request |
ByteStream |
要发送的诊断服务请求(ByteStream) |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - : |
CallServiceFunctional¶
以功能寻址方式执行诊断服务请求。
示例:要调用 UDS 服务 Read Data by Identifier(SID=0x22,DID=0xACDC),Request 为 ByteStream(“22 AC DC”)
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Request |
ByteStream |
要发送的诊断服务请求。ByteStream |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
object |
诊断结果列表(:)。 |
ClearDTCs¶
ClearDiagnosticInformation (0x14):清除一个或多个服务器内存中的诊断信息。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
GroupOfDTC |
0xFFFFFF |
int |
要清除的 DTC 或 DTC 组的编号(默认值:0xFFFFFF = 所有 DTC) |
||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DiagResult - 或 NegativeResponse |
CloseSession¶
关闭诊断会话。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
DiagnosticSessionControl¶
DiagnosticSessionControl (0x10):在服务器中启用不同的诊断会话。注意,切换诊断会话可能导致 ECU 复位。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
SessionType |
int |
要发送的诊断会话。1: DefaultSession, 2: ProgrammingSession, 3: ExtendedDiagnosticSession, 4: Safety SystemDiagnosticSession |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DiagnosticSessionControlResult - 或 NegativeResponse |
ECUReset¶
ECUReset (0x11):请求服务器复位。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Subfunction |
int |
要执行的复位子功能 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - ECUResetResult - 或 NegativeResponse |
InputOutputControlByIdentifier¶
InputOutputControlByIdentifier (0x2F):用某个值替代输入信号、服务器内部函数,和/或强制将电子系统的输出(执行器)控制在某个值上。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
ControlEnableMaskRecord |
ByteStream |
位掩码,用于指定 shortTermAdjustment 时要调整的参数。ISO 14229-1 规定仅当 DID 由多个参数组成时才使用。 |
|||
ControlStateRecord |
ByteStream |
Control 类型 “shortTermAdjustment” 的 DataRecord |
|||
DataIdentifier |
int |
Identifier |
|||
InputOutputControlParameter |
int |
根据 ISO 14229-1 附录 E.1 的控制类型: 0 = returnControlToECU, 1 = resetToDefault, 2 = freezeCurrentState, 3 = shortTermAdjustment |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - InputOutputControlByIdentifierResult - 或 NegativeResponse |
OpenDiagSession¶
打开使用 ISO-TP 的 UDS 诊断会话。若已存在使用指定参数的会话,则返回现有会话的句柄,而不是打开新会话。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
AddressByte |
ByteStream |
网络目标地址或地址扩展(仅与扩展寻址或混合寻址相关) - 长度为 1 的 ByteStream |
|||
AddressMode |
0 |
int |
寻址模式代码 - 整数(0:标准寻址 | 1:扩展寻址) |
||
BlockSize |
0 |
int |
可连续接收而无需中间流控的帧数(0 - 255) - Integer |
||
DiagTimeoutCanIsoTp |
2000 |
int |
通过 ISO-TP 协议等待诊断请求响应时的超时时间,单位为毫秒 - 整数 |
||
FillByte |
ByteStream |
用于填充报文的字节(可选) - 长度为 1 的 ByteStream |
|||
FlowControlAddressByte |
ByteStream |
FlowControl 使用不同的网络目标地址或地址扩展(仅与扩展寻址和混合寻址相关)- 长度为 1 的 ByteStream |
|||
FlowControlId |
int |
流控消息的消息 ID(可选)- 十六进制(可选整数) |
|||
IsExtended |
-1 |
int |
是否使用扩展 CAN-ID 格式?(1=是 / 29 位;0=否 / 11 位;-1 = 使用 TBC 中的设置) |
||
IsExtendedFlowControlId |
-1 |
int |
是否使用扩展 CAN ID 格式(用于 FlowControlId)?(1=是/29 位;0=否/11 位;-1 = 使用与 IsExtended 相同的设置) |
||
IsExtendedRequestId |
-1 |
int |
是否对 RequestId 使用扩展 CAN ID 格式?(1=是/29 位;0=否/11 位;-1 = 使用与 IsExtended 相同的设置) |
||
IsExtendedResponseId |
-1 |
int |
是否对 ResponseId 使用扩展 CAN ID 格式?(1=是/29 位;0=否/11 位;-1 = 使用与 IsExtended 相同的设置) |
||
RequestId |
int |
ECU 请求的报文 ID - 十六进制(可选,整数) |
|||
ResponseId |
int |
ECU 响应的消息 ID - 十六进制(可选 Integer) |
|||
SeparationTime |
0 |
int |
连续片段之间的最小时间间隔 0x00..0x7F => 0..127ms,0x80..0xf0 => 保留,0xf1..0xf9 => 100.900µs,0xfa..0xff => 保留 - 整数 |
||
StartRequest |
ByteStream |
用于打开会话的诊断请求(可选) - ByteStream |
|||
StopRequest |
ByteStream |
用于结束会话的诊断请求(可选) - ByteStream |
|||
TesterPresentCycleTime |
int |
周期性 tester-available 信令的周期长度(ms,可选)- Integer |
|||
TesterPresentRequest |
ByteStream |
用于周期性 tester-available 信号的诊断请求(可选)- ByteStream |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionHandle |
int |
诊断会话的句柄 |
OpenTcfDiagSession¶
打开在 TCF 中配置的诊断会话。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SUT |
object |
诊断会话的句柄。可以是 TCF 中指定的 SUT 名称,或 None。仅当只指定了一个 SUT 时才能使用 None。 |
ReadDataByIdentifier¶
ReadDataByIdentifier (0x22):按一个或多个 dataIdentifier 从服务器请求数据记录值。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
DataIdentifier |
int |
Identifier |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DataRecordDiagResult - 或 NegativeResponse |
ReadMemoryByAddress¶
ReadMemoryByAddress (0x23):允许客户端通过提供的起始地址和要读取的内存大小向服务器请求内存数据。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
MemoryAddress |
int |
内存地址 |
|||
MemorySize |
int |
要读取的数据长度 |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - MemoryDiagResult - 或 NegativeResponse |
ReportDTCByStatusMask¶
ReadDTCInformation (0x19) reportDTCByStatusMask (0x02):该参数指定服务器应向客户端发送与客户端定义的状态掩码相匹配的 DTC 列表及相应状态。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
StatusMask |
0xFF |
int |
状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态) |
||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse |
ReportDTCFaultDetectionCounter¶
ReadDTCInformation (0x19) reportDTCFaultDetectionCounter (0x14):此参数指定服务器应向客户端发送当前“prefailed”DTC 的列表,这些 DTC 已被或尚未被检测为“pending”或“confirmed”。
DTCFaultDetectionCounter 的用途是提供一种简单方法,用于识别某个特定 DTC 的 statusOfDTC 字节无法识别/读取的渐进性问题或间歇性问题。DTCFaultDetectionCounter 的内部实现应视车辆制造商而定(例如字节数、有符号还是无符号等),但报告的值应为缩放后的 1 字节有符号值,使得 +127 (7F16) 表示测试结果为 “failed”,而任何其他非零正值表示测试结果为 “prefailed”。但 DTCFaultDetectionCounter 值为 +127 的 DTC 不应按下述规则报告。每次测试逻辑运行并指示该次测试运行失败时,DTCFaultDetectionCounter 应按车辆制造商规定的量递增。
报告的 DTCFaultDetectionCounter 值大于零且小于 +127(即 0116 至 7E16)表示已满足 DTC 启用条件,并且未完成的测试结果至少在一个条件或阈值上处于 prefailed 状态。
只应报告 DTCFaultDetectionCounter 为小于 +127 (7F16) 的非零正值的 DTC。
每当测试逻辑运行并指示该次测试通过时,DTCFaultDetectionCounter 应按整车制造商规定的数值递减。如果 DTCFaultDetectionCounter 递减到零或以下,则不应再在肯定响应报文中报告该 DTC。DTCFaultDetectionCounter 的值不应在操作循环之间保持。
若收到 ClearDiagnosticInformation 服务请求,则所有 DTC 的 DTCFaultDetectionCounter 值均应重置为零。其他重置条件应由车辆制造商定义。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DTCFaultCounterDiagResult - 或 NegativeResponse |
ReportDTCSnapshotIdentification¶
ReadDTCInformation (0x19) reportDTCSnapshotIdentification (0x03):此参数规定,服务器应向客户端发送所有 DTCSnapshot 数据记录标识 [DTC 编号与 DTCSnapshot 记录编号]。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DTCSnapshotIdentificationDiagResult - 或 NegativeResponse |
ReportDTCSnapshotRecordByDTCNumber¶
ReadDTCInformation (0x19) reportDTCSnapshotRecordByDTCNumber (0x04):此参数规定服务器应向客户端发送与客户端定义的 DTC 编号和 DTCSnapshot 记录编号相关联的 DTCSnapshot 记录(FF16 表示所有记录)。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
DoExtendedInterpretation |
False |
[False, True] |
bool |
如果要以解释后的形式返回快照数据,则为 True,否则为 False。解释通过额外的 ReadDataByIdentifier 调用(0x22)完成。仅适用于固定长度的数据标识符值。默认值:False |
|
DTCMaskRecord |
object |
DTC 标识符:3 字节值,包含 DTCHighByte、DTCMiddleByte 和 DTCLowByte,三者共同构成要报告的诊断故障码的唯一标识号。例如 0x123456 或 SAE J2012 P-code:“P1234-56” |
|||
DTCSnapshotRecordNumber |
int |
DTC 快照记录编号:要检索其 DTC 快照记录数据的指定 DTC 的特定发生实例。若应报告所有已记录的快照,请指定 0xFF。 |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DTCSnapshotRecordDiagResult - 或 NegativeResponse |
ReportDTCWithPermanentStatus¶
ReadDTCInformation (0x19) reportDTCWithPermanentStatus (0x15):此参数规定,服务器应向客户端发送具有“permanent DTC”状态的 DTC 列表。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse |
ReportEmissionsOBDDTCByStatusMask¶
ReadDTCInformation (0x19) reportEmissionsOBDDTCByStatusMask (0x13):该参数规定,服务器应向客户端发送与排放相关的 OBD DTC 列表以及与客户端定义的状态掩码相匹配的相应状态。所报告的 OBD DTC 列表应仅包含需要符合排放相关法规要求的 DTC。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
StatusMask |
0xFF |
int |
状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态) |
||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse |
ReportFirstConfirmedDTC¶
ReadDTCInformation (0x19) reportFirstConfirmedDTC (0x0C):此参数规定服务器应向客户端发送自上次清除诊断信息以来服务器检测到的第一个已确认 DTC。
通过该 SubFunction 参数报告的信息应独立于已确认 DTC 的老化过程(例如,如果某个 DTC 老化到其状态允许被重置,则无论之后又有哪些其他 DTC 变为已确认,服务器都应继续保留第一条已确认的 DTC 记录)。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse |
ReportFirstTestFailedDTC¶
ReadDTCInformation (0x19) reportFirstTestFailedDTC (0x0B):此参数规定服务器应向客户端发送自上次清除诊断信息以来服务器检测到的第一个失败的 DTC。注意,通过此 SubFunction 参数报告的信息与 DTC 是否已确认或已老化无关。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse |
ReportMirrorMemoryDTCByStatusMask¶
ReadDTCInformation (0x19) reportMirrorMemoryDTCByStatusMask (0x0F):该参数规定,服务器应向客户端发送从 DTC 镜像存储器中取出的 DTC 列表以及与客户端定义的状态掩码相匹配的相应状态。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
StatusMask |
0xFF |
int |
状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态) |
||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse |
ReportMostRecentConfirmedDTC¶
ReadDTCInformation (0x19) reportMostRecentConfirmedDTC (0x0E):此参数指定服务器应向客户端发送自上次清除诊断信息以来检测到的最新已确认 DTC。
请注意,通过此 SubFunction 参数报告的信息应独立于已确认 DTC 的老化过程(例如,如果某个 DTC 老化到其状态允许被复位,则在之后没有其他 DTC 变为已确认的情况下,服务器应继续保留第一条已确认 DTC 记录)。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse |
ReportMostRecentTestFailedDTC¶
ReadDTCInformation (0x19) reportMostRecentTestFailedDTC (0x0D):此参数规定,服务器应向客户端发送自上次清除诊断信息以来服务器检测到的最新一次失败的 DTC。请注意,通过此 SubFunction 参数报告的信息应与该 DTC 是否已确认或已老化无关。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse |
ReportNumberOfDTCByStatusMask¶
ReadDTCInformation (0x19) reportNumberOfDTCByStatusMask (0x01):该参数规定,服务器应向客户端传输与客户端定义的状态掩码相匹配的 DTC 数量。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
StatusMask |
0xFF |
int |
状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态) |
||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DTCNumberDiagResult - 或 NegativeResponse |
ReportNumberOfEmissionsOBDDTCByStatusMask¶
ReadDTCInformation (0x19) reportNumberOfEmissionsOBDDTCByStatusMask (0x12):此参数指定服务器应向客户端发送与客户端定义的状态掩码相匹配的排放相关 OBD DTC 数量。所报告的 OBD DTC 数量应仅为那些需要与排放相关法规要求兼容的 DTC。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
StatusMask |
0xFF |
int |
状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态) |
||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DTCNumberDiagResult - 或 NegativeResponse |
ReportNumberOfMirrorMemoryDTCByStatusMask¶
ReadDTCInformation (0x19) reportNumberOfMirrorMemoryDTCByStatusMask (0x11):该参数规定,服务器应向客户端发送镜像存储器中与客户端定义的状态掩码相匹配的 DTC 数量。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
StatusMask |
0xFF |
int |
状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态) |
||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DTCNumberDiagResult - 或 NegativeResponse |
ReportSupportedDTCs¶
ReadDTCInformation (0x19) reportSupportedDTC (0x0A):此参数规定服务器应向客户端发送服务器内支持的所有 DTC 及对应状态的列表。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse |
ReportUserDefMemoryDTCByStatusMask¶
ReadDTCInformation (0x19) reportUserDefMemoryDTCByStatusMask (0x17):此参数规定,服务器应向客户端发送用户自定义 DTC 存储区中的 DTC 及其状态列表,这些状态需与客户端定义的状态掩码匹配。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
MemorySelection |
int |
用户定义的 DTC 存储器:只检索存储在所选存储器中的 DTC。 |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
StatusMask |
0xFF |
int |
状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态) |
||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - UserDTCListDiagResult - 或 NegativeResponse |
RequestDownload¶
RequestDownload (0x34):用于发起从客户端到服务器的数据传输(下载)。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
DataFormatIdentifier |
00 |
ByteStream |
指定对要发送的数据所用压缩(高半字节)和加密(低半字节)方法。值 0 表示不压缩也不加密。其他所有值均由制造商定义。 ByteStream |
||
MemoryAddress |
ByteStream |
要写入数据的服务器内存起始地址。ByteStream |
|||
MemorySize |
ByteStream |
TransferData 作业要发送的数据大小。如果对数据使用了压缩,则此参数是指压缩后数据的大小还是未压缩数据的大小取决于制造商。ByteStream |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - RequestDownloadResult - 或 NegativeResponse |
RequestTransferExit¶
RequestTransferExit (0x37):客户端用它结束客户端与服务器之间的数据传输(上传或下载)。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DiagResult - 或 NegativeResponse |
RoutineControl¶
RoutineControl (0x31):客户端使用 RoutineControl 服务执行已定义的步骤序列,并获取相关结果。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
hasRoutineInfo |
[False, True] |
bool |
optional |
||
RoutineId |
int |
例程的 ID |
|||
RoutineOptionRecord |
ByteStream |
例程参数(可选) ByteStream |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Subfunction |
1 |
int |
子功能:Start (0x01)、Stop (0x02)、Request (0x03) |
||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - RoutineDiagResult - 或 NegativeResponse |
SecurityAccessRequestSeed¶
SecurityAccess (0x27) requestSeed:请求具有车辆制造商所定义安全级别的种子。此外还可以指定一个 Seed&Key 库,用于计算与所获种子对应的密钥。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Options |
object |
要传递给 Seed&Key 库的选项字符串(可选 - str)。如果 Options 为 None,则调用库函数 GenerateKeyEx()。如果 Options 是字符串,则调用库函数 GenerateKeyExOpt(),即使是空字符串也是如此。 |
|||
SecurityAccessDataRecord |
ByteStream |
请求 seed 信息时额外传输的数据(可选)。ByteStream |
|||
SecurityLevel |
int |
要解锁的安全级别,0x01 与 0x7D 之间的奇数 |
|||
SeedAndKeyLibraryPath |
string |
用于计算与所获得种子对应的密钥的 Seed&Key 库路径(可选) |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
|||
Variant |
string |
要传递给 Seed&Key 库的 ECU 变体限定符(可选) |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - SecurityAccessDiagResult - 或 NegativeResponse |
SecurityAccessSendKey¶
SecurityAccess (0x27) sendKey:发送带有车辆制造商定义的安全等级的密钥。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SecurityKey |
ByteStream |
用于解锁所需安全级别的密钥。如果 SecurityAccessRequestSeed Job 使用了 Seed&Key 库,则计算出的密钥会在 SecurityAccessRequestSeed Job 的结果中返回。否则必须事先根据 SecurityAccessRequestSeed Job 结果中返回的 seed 计算出密钥。ByteStream |
|||
SecurityLevel |
int |
要解锁的安全级别,0x02 到 0x7E 之间的偶数(= SecurityAccessRequestSeed 的 SecurityLevel + 1) |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - DiagResult - 或 NegativeResponse |
SetDiagTimeout¶
设置诊断会话的超时时间。注意:如果在诊断请求进行期间设置超时,时序行为可能不可预测。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
DiagTimeout |
int |
超时时间(ms)。如果将该值设置为 None,则在打开会话时,超时时间会重置为初始值。 |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
SetFlowControlCTS¶
激活后,将始终发送流控制“ContinueToSend”消息来响应分段请求。此外,还可以为内部参数 BlockSize 和 SeparationTime 赋予新值。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
BlockSize |
int |
可连续接收而无需中间流控的帧数(0 - 255) - Integer 如果为 None,则保留来自测试配置、OpenDiagSession 作业或上一次 SetFlowControlCTS 调用的最新设置。 |
|||
SeparationTime |
int |
连续片段之间的最小时间间隔 0x00..0x7F => 0..127ms,0x80..0xf0 => 保留,0xf1..0xf9 => 100.900µs,0xfa..0xff => 保留 - 整数 如果为 None,则保留来自测试配置、OpenDiagSession 作业或上一次 SetFlowControlCTS 调用的最新设置。 |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
SetFlowControlWait¶
激活后,对分段请求始终发送流控 “Wait” 消息。注意:激活期间无法接收任何分段消息。使用 Job SetFlowControlCTS 重置此行为。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
WaitTimeInterval |
0 |
int |
等待时间间隔,单位为 ms。如果设为 0,则只发送一次流控制“Wait”消息以响应分段请求。如果设为大于 0 的值,则按给定间隔周期性发送流控制“Wait”消息。 |
SetTesterPresent¶
更改测试配置中为周期性发送的 TesterPresent 报文指定的参数。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
TesterPresentCycleTime |
int |
周期性发送请求的周期长度(ms)。若将周期长度指定为 0,则停用周期性发送 |
|||
TesterPresentRequest |
ByteStream() |
ByteStream |
循环发送的报文的数据载荷 |
TransferData¶
TransferData (0x36):客户端用于传输数据,既可从客户端到服务器(download),也可从服务器到客户端(upload)。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
BlockLength |
int |
一个块内可传输的最大数据量。包含相应块的服务 ID 和序列计数器。- int |
|||
FlashData |
ByteStream |
要传输的总数据。该作业会根据块长度参数中指定的值自动拆分数据。 ByteStream |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - TransferDataResult |
WriteDataByIdentifier¶
WriteDataByIdentifier (0x2E):允许客户端在服务器中由所提供的数据标识符指定的内部位置写入信息。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
DataIdentifier |
int |
Identifier |
|||
DataRecord |
ByteStream |
要写入的数据记录 ByteStream |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - WriteDataByIdentifierResult - 或 NegativeResponse |
WriteMemoryByAddress¶
WriteMemoryByAddress (0x3D):WriteMemoryByAddress 服务允许客户端向服务器的一个或多个连续内存位置写入信息。
此作业属于 Add-on ecu.test diagnostics。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
DataRecord |
ByteStream |
要写入的数据 ByteStream |
|||
MemoryAddress |
int |
要写入数据的起始地址 |
|||
MemorySize |
int |
要写入的字节数 |
|||
SessionId |
object |
诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。 |
|||
Timeout |
int |
诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Return |
DiagResult |
诊断服务调用的结果 - WriteMemoryByAddressResult - 或 NegativeResponse |